home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lantools / lmail160 / lanmail.doc next >
Text File  |  1992-08-08  |  18KB  |  338 lines
  1.  
  2.  
  3. Version 1.60                        LANMail                         08/08/1992
  4.  
  5.  
  6.    LANMail is a 6K swapping TSR program that allows you to send, receive, and
  7. output LANTastic e-mail.  Also, LANMail provides users with an easy way to
  8. send and respond to pop-up messages.
  9.    As mentioned before LANMail is a swapping TSR which means that when the
  10. hot-key sequence is pressed to activate LANMail, LANMail will swap itself into
  11. memory.  This requires LANMail to store what was previously in memory.  For
  12. this, LANMail will use EMS memory if available, or will create temporary files
  13. on the C: drive by default, or on any other drive as specified by command line
  14. parameters (See RUNNING LANMAIL section below).
  15.  
  16.  
  17. READING MAIL
  18. ============
  19.    When the user selects 'R' from the Net-Mail Services menu, the user will
  20. then be shown the header from the first piece of mail in the mailbox.  This
  21. header contains who the mail is from, the time and date it was sent, and the
  22. subject or comment attached to the message.  If the user wants to read this
  23. message, then he/she should answer 'Y' to "Read this message now [Y,N] ?" Any
  24. other key besides 'Y' will skip to the next message.
  25.  
  26.    After reading the message, the user is presented with the question:
  27.         "<<<End of message>>> (P)rint, (F)orward, (R)eply,
  28.            (D)elete, or (N)ext message ? N "
  29.  
  30.    If the user responds with a 'P', the question
  31.           "Output to (F)ile, (P)rinter, or (N)one ?"
  32.        will appear.  Answering 'F' will allow the user to append toe
  33.        message to the end of a file, or create a new file if necessary.
  34.        Answering 'P' will allow the user to print the message to a
  35.        printer, and answering 'N' will abort the output.  After the
  36.        message has been printed, the user will be asked the question:
  37.           "Delete this message ? N"
  38.        If the user responds with a 'Y' then the message will be deleted
  39.        from their mailbox.  Any other response, and the message will
  40.        remain in their mailbox.
  41.  
  42.    If the user responds with a 'F' then a free-format message screen will
  43.        appear with the contents of the original message already entered.
  44.        This message can now be edited as any free-form message could be
  45.        (see instructions below).  After the forwarded message has been
  46.        sent, the user will be asked the question:
  47.           "Delete this message ? N"
  48.        If the user responds with a 'Y' then the message will be deleted
  49.        from their mailbox.  Any other response, and the message will
  50.        remain in their mailbox.
  51.  
  52.    If the user responds with a 'R' then a blank free-format message screen
  53.        will appear. Unlike a forwarded message, the user cannot select
  54.        which users to send the reply to, only the person who sent the
  55.        message will receive the reply. After the reply has been sent, the
  56.        user will be asked the question:
  57.           "Delete this message ? N"
  58.        If the user responds with a 'Y' then the message will be deleted
  59.        from their mailbox.  Any other response, and the message will
  60.        remain in their mailbox.
  61.  
  62.  
  63. LANMail                          Version 1.60                           Page 2
  64.  
  65.    If the user responds with a 'D' then the message will be deleted from the
  66.        mailbox.
  67.  
  68.    If the user responds with an 'N' or any other key besides P F R D then the
  69.        next message header will be displayed.
  70.  
  71. SENDING MAIL
  72. ============
  73.    LANMail supports the use of a username file for networks that are not using
  74. individual user accounts.  The username file is a text file with the name of
  75. each user on a separate line.  The file must be in the same directory that
  76. LANMAIL.EXE is in, and should be named LANMAIL.USR.  The file can be created
  77. by any editor that can save files in pure ASCII such as PC-Write, or the
  78. editor included in MS-DOS v5.00.
  79.    LANMail lets the user send mail to the message server in two formats: a
  80. free-form format, and a Phone Message format.
  81.  Free-Format
  82.  -----------
  83.    The free-format is for messages not suitable for a Phone Message. Free-form
  84. messages can be sent 3 ways: Selecting 'S' from the Net-Mail Services menu,
  85. Forwarding a message after reading, or Replying to a message after reading.
  86.    When entering in a free-form message, there are a few editing features
  87. available...
  88.        <HOME>    key brings you to the beginning of the current line
  89.        <END>     key brings you to the end of the current line
  90.        <INS>     key inserts a space at the cursor location
  91.        <DEL>     key deletes the character under the cursor
  92.        <Ctrl F>  Inserts a file above the current line
  93.        <Ctrl I>  inserts a line above the current line
  94.        <Ctrl Y>  deletes the current line.
  95.        <ESC>     key aborts the message
  96.        <F1>      key saves the message
  97.        <Ctrl >  word left
  98.        <Ctrl >  word right
  99.          represent the cursor keys
  100.  
  101.    After pressing <F1> to finish entering the free-form message, if you are
  102. replying to a message, you will be prompted for a subject. After entering the
  103. subject, the message will be sent.  If you are forwarding a message, or used
  104. the 'S' selection from the Net-Mail Services menu, then you will be presented
  105. with a list of users. Use the up and down cursor keys to move the highlight
  106. bar, pressing the space bar to toggle a users' name.  A check mark √ will
  107. appear beside the names of the users the message will be sent to. After
  108. selecting the desired users, press <Enter> to finalize your selection, or <ESC>
  109. to abort the message.  After pressing <Enter>, you may then enter a subject.
  110. After the subject is entered, the message will be sent to all the selected
  111. users.
  112.  
  113.  
  114. LANMail                          Version 1.60                           Page 3
  115.  Phone Message
  116.  -------------
  117.    The 'P' selection from the Net-Mail Services menu allows the user to send a
  118. message in the form of a "While you were out" phone message.  The user is
  119. presented with a form that looks similar to the popular paper version of the
  120. phone message. To check the boxes, while in the box you want checked, hit any
  121. letter, to clear the check, press the space bar. Use the up and down cursor
  122. keys to move around to the various fields. (NOTE: The phone number field will
  123. try to automaticly format the number you enter so entering 2055551212 will
  124. give you 205-555-1212 when you leave the field.) Once you are satisfied with
  125. the message, press the <F1> key to send it, or <ESC> to abort. After pressing
  126. <F1> you will be presented with a list, just as you were when sending a free
  127. form message.
  128.    When a phone message is sent, a carbon copy of the message is saved in a
  129. text file called LANMAIL.CRB located in the directory in which LANMail program
  130. is located.  This is helpful if you need to look back at phone messages from
  131. the past to find a phone number etc.
  132.  
  133. SENDING POP-UP MESSAGES
  134. =======================
  135.    The 'M' selection from the Net-Mail Services menu allows you to send a
  136. pop-up message to any user in the user list.
  137.    After pressing 'M' from the Net-Mail Services menu, you will provided with
  138. a list of users. Use the up and down cursor keys to move the highlight bar,
  139. pressing the space bar to toggle a user name.  A check mark √ will appear
  140. beside the names of the users the pop-up message will be sent to. After
  141. selecting the desired users, press <Enter> to finalize your selection, or
  142. <ESC> to abort the pop-up message.  After pressing <Enter>, you may then enter
  143. a the pop-up message you wish to send. If you press the <Enter> key, the
  144. message will be sent to the selected users, if your press the <ESC> key the
  145. message will be aborted.
  146.  
  147.  
  148. RESPONDING TO POP-UP MESSAGES
  149. =============================
  150.    The 'L' selection from the Net-Mail Services menu allows you to respond to
  151. the last pop-up message received.
  152.    After pressing 'L' from the Net-Mail Services menu, you will see the name
  153. of the machine that sent the last pop-up message, and the contents of the
  154. message.  Now, to send a pop-up message as a response, all you have to do is
  155. type in your message. If you press the <Enter> key, your message will be sent,
  156. or if you press the <ESC> key, the message will be aborted.
  157.  
  158. RUNNING LANMAIL
  159. ===============
  160.    LANMail supports the use of a configuration file to contain commonly used
  161. command line options.  The configuration file is a text file with each command
  162. line option (including the / or -) on a separate line.  The file must be in
  163. the same directory that LANMAIL.EXE is in, and should be named LANMAIL.CFG.
  164. The file can be created by any editor that can save files in pure ASCII such
  165. as PC-Write, or the editor included in MS-DOS v5.00.  Any options used on the
  166. command line override options found in the configuration file.
  167.    When LANMail is run for the first time, the program must be initialized.
  168. This initialization can take up to 5 minutes, but will only be performed once.
  169.  
  170.  
  171. LANMail                          Version 1.60                           Page 4
  172.  
  173.    To run LANMail type:
  174.        LANMAIL /P:{MESSAGE_SERVER} [/S] [/Fpath] [/U] [/K:{Hot-key sequence}]
  175. where {MESSAGE-SERVER} is the name of the server mail and phone messages are
  176. to be sent to.  This parameter must be provided, if it is not, the user will
  177. be prompted to input the phone message server.
  178.  
  179.    The /S parameter can be used to run LANMail in a "stand alone" mode.  This
  180. allows you to run the LANMail program without installing it as a TSR.
  181.    The /F parameter allows you to specify where the 2 swapfiles will be placed.
  182. There is no error checking at this time, so make sure it is a valid location.
  183. (Swap files will only be used if there is not sufficient EMS or extended
  184. memory available for the swap)  If the /F parameter is not used C:\ is
  185. assumed.  An example would be:
  186.        LANMAIL /P:MAIL-SERVER /FD:\TEMP   (Swap files in D:\TEMP)
  187.                     or
  188.        LANMAIL /P:MAIL-SERVER /FD:\       (Swap files in the root of D:)
  189.  
  190.    The /U parameter will attempt to uninstall the LANMail TSR.
  191.  
  192.    The /K parameter allows the user to define a hot key sequence besides the
  193. default sequence of (Alt)(LShift)(~).  An example to set the hot key to
  194. Control Alternate M would be:
  195.        /K:(Ctrl)(Alt)(M)
  196.  
  197.        (Ctrl)   Control key       (Alt)     Alt key
  198.        (LShift) Left shift key    (RShift)  Right shift key
  199.        (F1)     F1 function key   (F2..F12) Corresponding function keys
  200.        The letters A-Z, the number 0-9, and all punctuation characters can
  201.        be used.
  202.        NOTE: Only one "main key" can be used.  The main key in the example
  203.                above is the letter M
  204.  
  205.    The /T and /B parameters allow the user to designate text (/T) color and
  206. background (/B) color.  The default colors are White text on a Black
  207. background. Use the following values for the colors:
  208.  
  209.        Black = 0    Red       = 4    DarkGray   = 8     LightRed     = 12
  210.        Blue  = 1    Magenta   = 5    LightBlue  = 9     LightMagenta = 13
  211.        Green = 2    Brown     = 6    LightGreen = 10    Yellow       = 14
  212.        Cyan  = 3    LightGray = 7    LightCyan  = 11    White        = 15
  213.              (Only colors 0 - 7 can be used for background colors)
  214.  
  215. For example if you wanted White letters on a Blue background you would use
  216. /T:15 /B:1
  217.  
  218. MISCELLANEOUS INFORMATION
  219. =========================
  220.    Since LANMail is a swapping TSR, care and consideration needs to be taken
  221. when loading.  If you are using a software disk cache, mouse driver, etc. it
  222. is important that LANMail be loaded AFTER these programs.  If these such
  223. programs are loaded AFTER LANMail, then it is possible that when LANMail is
  224. active, a call to these programs could lock-up your computer.  An example of
  225. this is the LANPop program.  If you use LANPop with LANMail it is important
  226. that you load LANPop BEFORE loading LANMail.
  227.  
  228.  
  229. LANMail                          Version 1.60                           Page 5
  230.  
  231.    LANMail was written using Turbo Power's TSRs Made Easy V1.00 and compiled
  232. under Borland's Turbo Pascal v5.5.  I highly recommend TSR's Made Easy for any
  233. Turbo Pascal programmer wishing to make their programs run as TSRs with
  234. minimal effort and change.  Turbo Power can be reached on CompuServe at user
  235. id 76004,2611 or by phone at (719) 260-6641.
  236.  
  237. DISCLAIMER
  238. ==========
  239.    PAUL DURDEN MAKES NO CLAIMS, WRITTEN OR IMPLIED, AS TO THE STABILITY OR
  240. OPERATION OF THIS PROGRAM. USE IT SOLELY AT YOUR OWN RISK! WHILE I BELIEVE
  241. THAT IT PERFORMS ITS INTENDED FUNCTION AS OUTLINED IN THIS DOCUMENT, PAUL
  242. DURDEN WILL NOT BE RESPONSIBLE FOR ANY ADVERSE REACTIONS WHICH MAY BE CAUSED
  243. BY ITS USE.
  244.  
  245.  
  246. REGISTRATION & LEGALITIES
  247. =========================
  248.    LANMail is not freeware, nor is it in the public domain. It is a shareware
  249. program, and the entire program and documentation are Copyright (C) 1992, Paul
  250. Durden, Huntsville, AL. You are encouraged to copy the package freely,
  251. including distribution by BBS, shareware library, or other means, provided
  252. that no fee of more than five US dollars ($5) shall be charged for the copy,
  253. and that the distribution shall consist of the original archive containing the
  254. following files:
  255.    LANMAIL.EXE    The LANMail Mail services program.
  256.    LANMAIL.DOC    This file.
  257.    LANPOP.EXE     The LANPop program.
  258.    LANPOP.DOC     Documentation for the LANPop program.
  259.    REGISTER.DOC   Registration form.
  260.  
  261.    Of course, if you experience a problem using this program, I would like to
  262. know about it. IF YOU USE THIS PROGRAM FOR MORE THAN 21 (TWENTY-ONE) DAYS,
  263. PLEASE REGISTER IT BY PRINTING AND COMPLETING THE REGISTRATION FORM
  264. (REGISTER.DOC), AND SENDING IT ALONG WITH A CHECK/MONEY ORDER FOR $30 U.S.
  265. DOLLARS PAYABLE TO "Paul Durden" to:
  266.        Paul Durden
  267.        LANMail Registration
  268.        P.O. Box 7234
  269.        Huntsville, AL 35807
  270.  
  271.    The registration covers both the LANMail program and the LANPop program. By
  272. registering, you will receive the most recent release of both the LANMail and
  273. LANPop programs, and will be notified of any future releases.
  274.  
  275.    If you need to contact me for any reason you may reach me at the above
  276. address, or leave e-mail for Paul Durden on Artisoft's ArtiFACTS BBS, or ID
  277. 76360,2306 on CompuServe.
  278.  
  279.  
  280.                                VERSION HISTORY 
  281. Version                Changes
  282. --------     ----------------------------------------------------------------
  283.   1.20     *   Initial release to public
  284.   1.21     *   Output to printers made less cryptic (hopefully), time-stamp
  285.                problem fixed. Error trapping while reading mail cleaned-up.
  286.  
  287.   1.25     *   Hot-key sequence is now runtime definable.  Text background
  288.                and foreground colors are now initialized to White text on a
  289.                Black background, this hopefully will help monochrome users
  290.                whose cursor disappears while using LANMail due to the
  291.                current programs text attributes.
  292.  
  293.   1.30     *   When selecting users to send a message to, a highlight bar is
  294.                used rather than just the cursor so as to help those with the
  295.                disappearing cursor.
  296.            *   Insert and Delete line capabilities added to the free-format
  297.                message editor.
  298.            *   Added the ability to forward or reply to a message after
  299.                reading it.
  300.  
  301.   1.35     *   Added ability to change text and background color of popup
  302.                screen.
  303.            *   Added the ability to insert a file (<Ctrl F>) into a free
  304.                format message.
  305.            *   Most error messages now require the user to press a key before
  306.                continuing so the error message can be noted for bug reports.
  307.  
  308.   1.40ß    *   LANMail now gets user names from both the MESSAGE_SERVER, but
  309.                also from a text file named LANMAIL.USR located in the same
  310.                directory as LANMAIL.EXE.  The username file consists of one
  311.                username per line, and can be created by any editor than can
  312.                save in pure ASCII such as PC-Write or the editor that comes
  313.                with MS-DOS v5.00.
  314.            *   LANMail also now supports a configuration file named
  315.                LANMAIL.CFG for all command line arguments.  LANMail looks for
  316.                this file in the same directory as LANMAIL.EXE.  The
  317.                configuration file is a text file with one command line option
  318.                per line.  Note: you must still use the / or - just as if you
  319.                were at the command line.
  320.  
  321.   1.48ß    *   LANMail now has the ability to send and respond to pop-up
  322.                messages.
  323.  
  324.   1.50     *   LANMail now supports the TAB key in a free-format message.
  325.            *   Some cosmetic changes to the menus.
  326.            *   LANPop now packaged in archive.
  327.  
  328.   1.50C    *   LANMail now asks for confirmation when aborting a message, or
  329.                when aborting a selection of users.
  330.  
  331.   1.52     *   A bug that prevented mail from being saved to a new file was
  332.                fixed.
  333.            *   Word right (Ctrl-Cursor Right) and word left (Ctrl-Cursor Left)
  334.                were added to the free-format editor.
  335.   1.60     *   After Forwarding, Printing, or Replying to a message, you may
  336.                delete the message now without having to read it again.
  337.            *   Word wrap is now implemented in the free-format message.
  338.